Translate a ZMK

Command:

Translate a ZMK encrypted under the LMK pair held in “key change storage” to encryption under LMK pair 04-05.

Note:

If a 32-character ZMK is required, the HSM must be configured for double-length ZMKs using the CS (Configure Security) console command.

 

Field

Length & Type

Details

 

COMMAND MESSAGE

 

 

Message header

m A

(Subsequently returned to the Host unchanged).

 

Command code

2 A

Value GE.

 

ZMK

16H or 32H or
1A+32H or 1A+48H

The ZMK encrypted under the LMK pair held in “key change storage”.

 

Delimiter

1 A

Optional. If present the following three fields must be present.  Value “;”.

If an option is not required by the command fill with a valid value or 0.

 

Key scheme ZMK

1 A

Optional. Key scheme for encrypting key under ZMK.

 

Key scheme LMK

1 A

Optional. Key scheme for encrypting key under LMK.

 

Key check value type

1 A

Optional. Key check value calculation method

0 - KCV backwards compatible.

1 - KCV 6H.

 

End message delimiter

1 C

Optional. Must be present if a message trailer is present. Value X’19.

 

Message trailer

n A

Optional. Maximum length 32 characters.

RESPONSE MESSAGE

 

 

Message header

n A

Returned to the Host unchanged.

 

Response code

2 A

Value GF.

 

Error code

2 N

00 : No errors

10 : ZMK parity error

12 : No keys loaded in user storage

13 : LMK error; report to supervisor

15 : Error in input data

21 : Invalid user storage index

 

ZMK

16H or 32H or
1A+32H or 1A+48H

The ZMK translated to encryption under LMK pair 04-05.

 

End message delimiter

1 C

Present only if present in the command message. Value X’19.

 

Message trailer

n A

Present only if present in the command message. Maximum length 32 characters.